home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_300 / 339_01 / readme.1st < prev    next >
Text File  |  1990-12-12  |  11KB  |  268 lines
  1.  
  2.  
  3.  
  4.  
  5.      README.1ST
  6.      ===================================================================
  7.  
  8.              Readme File for "CTRLCLIB - The CTRL+C Library"(Tm)
  9.  
  10.         CTRLCLIB - The CTRL+C Library is Copyright 1990 by Trendtech
  11.             Corporation, Wayne, NJ, U.S.A. - All Rights Reserved
  12.  
  13.  
  14.      WHAT IS THE CTRL+C LIBRARY?
  15.  
  16.           CTRLCLIB -  The Ctrl+C  Library, contains C-language functions
  17.      that system designers, software developers, and programmers can use
  18.      to help  their PC  programs  manage  the  user-initiated  class  of
  19.      interrupts such  as  control-C,  control-break,  system  reset,  an
  20.      others.  User-initiated interrupts are software/hardware interrupts
  21.      that  are   generated  when   PC  users   press  unique   keystroke
  22.      combinations while running application programs under MS-DOS.
  23.  
  24.           With functions  from CTRLCLIB,  programmers can  gain  control
  25.      over and program for, the following kinds of interrupts:  All types
  26.      of user-initiated  program  "breaks"  -  control-c,  control-break,
  27.      control-2, and alt-3; the "pause" keys - control-s, and 'pause' (or
  28.      control-numlock); the  print screen keys - print-screen, control-p,
  29.      and control-printscreen,   and  others. The  program can  trap  the
  30.      system reset  keys, and/or  force either  a warm  or  cold  reboot.
  31.      There are  functions to  capture and  control the  setting  of  all
  32.      'lock' keys  such as  caps lock and num lock.  Programs can examine
  33.      keyboard make/break codes as they are typed by the user.
  34.  
  35.           If your  application is  time-critical and  you don't want the
  36.      user messing  with the PAUSE key and CTRL+S, simply call a function
  37.      from The  CTRL+C Library to disable them.   And, if you have to get
  38.      down to  the nitty-gritty  and capture keyboard MAKE - BREAK codes,
  39.      you can do that as well!
  40.  
  41.  
  42.           The following list is a summary of the kinds of user-initiated
  43.      interrupts that your program can catch using CTRLCLIB functions:
  44.  
  45.  
  46.           KEYPRESS INTERRUPT:          What it normally does:
  47.           ==============================================================
  48.  
  49.           o  CTRL+BREAK and CTRL+C   - Program termination
  50.  
  51.           o  CTRL+2 and ALT+Keypad 3 - Program termination
  52.  
  53.           o  The "^C" screen print   - Disrupts screen display
  54.  
  55.           o  CTRL+ALT+DEL            - System reset
  56.  
  57.           o  PRINT SCREEN            - Screen dump to printer
  58.  
  59.  
  60.  
  61.           o  CTRL+PRTSCRN and CTRL+P - Screen echo to printer
  62.  
  63.           o  PAUSE KEY or CTRL+NUML  - Stops processing until keystroke
  64.  
  65.           o  CTRL-S                  - Pause MS-DOS output to STDOUT
  66.  
  67.  
  68.           Your application program can also exercise a high degree of
  69.      control over the following keyboard keys with support functions
  70.      from The CTRL+C Library:
  71.  
  72.           o  CAPS LOCK KEY           - Full control
  73.  
  74.           o  NUM LOCK KEY            - Full control
  75.  
  76.           o  SCROLL LOCK KEY         - Full control
  77.  
  78.           o  INSERT LOCK KEY         - Full control
  79.  
  80.           o  KEYPAD 5                - Keypress Detection
  81.  
  82.      Full control options: ALWAYS-ON, ALWAYS-OFF, ON, OFF, TOGGLE
  83.  
  84.  
  85.           Your application can have these additional support functions
  86.      available as needed:
  87.  
  88.           o  REBOOT - Initiate a WARM or COLD reboot anytime
  89.  
  90.           o  DISPLAY THE "^C" CHARACTERS - when YOU want
  91.  
  92.           o  QUERY functions - determine if user pressed any of the
  93.                                interrupt keys.
  94.  
  95.  
  96.           Until now,  no one  has ever  addressed  the  issues  of  FULL
  97.      user-initiated  interrupt   management  control,   especially  with
  98.      respect to Ctrl-C and Ctrl-Break protection.  Yes, it's easy enough
  99.      to trap  these keys  and prevent  program termination, but it's NOT
  100.      easy to  stop  MS-DOS  from  throwing  up  the  insidious  "  ^C  "
  101.      characters on  the screen; this can be caused in a variety of ways.
  102.      Did you  know that  pressing CTRL+2 and ALT+keypad 3 is the same as
  103.      pressing CTRL+C??   The  CTRL+C Library knows about them and blocks
  104.      them out  too.    Our  long-term  goal  is  to  make  CTRLCLIB  the
  105.      definitive MS-DOS  standard  for  managing  user-initiated  program
  106.      interrupts.
  107.  
  108.  
  109.      HOW DO I SEE ALL THIS IN ACTION?
  110.  
  111.           Just run  the demo  programs.   CLDEMO.EXE  has  about  twenty
  112.      different tests  to illustrate  interrupt control.   We suggest you
  113.      print the CLDEMO.C source code and follow the code for each test to
  114.      see how  simple it  is to  use CTRLCLIB functions.  There is also a
  115.  
  116.  
  117.  
  118.      separate demo  program called BOOTDEMO.EXE to test the system reset
  119.      (reboot) functions.  The source code is included for this too.
  120.  
  121.  
  122.      EXCEPTIONS
  123.  
  124.           With the variety of PC's and keyboards on the market today
  125.      there are bound to be differences in behavior of certain keys - and
  126.      there is.  The section in the User's Guide and Reference Manual
  127.      that covers this extensively is called  "General Caveats" and
  128.      "Keyboard Idiosyncrasies".  We suggest you read this thoroughly.
  129.      If you're concerned about the behavior of certain keystrokes in
  130.      your application, remember that registration brings you full source
  131.      code.  You can then modify the source to fit your particular needs.
  132.  
  133.           We don't recommend using CTRLCLIB for programs written to run
  134.      in a protected mode environment provided by such control programs
  135.      as Microsoft Windows, DESQview, etc.  These systems provide their
  136.      own methods of user-initiated interrupt control.
  137.  
  138.  
  139.      TECHNICALS
  140.  
  141.           CTRLCLIB supports  PC/MS-DOS for  the IBM  PC/XT/AT, PS/2  and
  142.      80286 and  80386 compatibles.  CTRLCLIB is written entirely in "C";
  143.      there is  absolutely NO  assembly language  for you  to fool  with.
  144.      This package  has  linkable  object  libraries  for  the  following
  145.      compilers:
  146.  
  147.                Microsoft C Version 5.1
  148.                Microsoft C Version 6.0
  149.                Microsoft Quick-C Version 2.5
  150.                Borland Turbo-C Version 2.0
  151.                Borland Turbo-C++ Version 1.0
  152.  
  153.           Simply include  the functions  you need in your source code at
  154.      compile-time, plus  the CTRLCLIB  library that's  specific to  your
  155.      compiler and  memory-model size  at link-time.  That's all there is
  156.      to it.
  157.  
  158.  
  159.      INSTALLATION
  160.  
  161.           1) MAKE A BACKUP OF ALL DISKS before you do anything else!!!
  162.  
  163.           2) Use PKUNZIP to unarchive the various ZIP files.  Extract
  164.              only those files you need for use with a specific compiler.
  165.  
  166.           3) Copy the Library that corresponds to the compiler you are
  167.              using onto the disk partition that you usually use with
  168.              your "C" compiler.  The .LIB file should be located in the
  169.              same disk partition as your compilers' runtime libraries.
  170.  
  171.  
  172.  
  173.  
  174.      EVALUATION AND REGISTRATION
  175.  
  176.           CTRLCLIB is  a commercial  software package.   It is not free,
  177.      and it  is not  in  the  public  domain.    It  is  distributed  as
  178.      Shareware, which means that before you pay for the package, you may
  179.      evaluate it  and see if you want to continue using it.  You may use
  180.      CTRLCLIB free  for a trial period of up to 30 days.  If you wish to
  181.      continue  using   CTRLCLIB  after  that  period,  you  must  pay  a
  182.      registration fee.   If  you choose not to pay the registration fee,
  183.      you must  stop using  THE CTRL+C  LIBRARY and  remove it  from your
  184.      computer, though  you are  still free  to keep copies and pass them
  185.      along to  others.   You  cannot  link  any  CTRLCLIB  modules  into
  186.      commercially sold  software  products  without  first  obtaining  a
  187.      license from Trendtech Corporation by paying the registration fee.
  188.  
  189.  
  190.      IMPORTANT EVALUATION NOTE:
  191.  
  192.           Space limitations on the Shareware disk allow only two memory-
  193.      model libraries  for each  compiler.  If you can not fully evaluate
  194.      CTRLCLIB because